home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / printer / prngl126.zip / PRINTGL.DOC < prev    next >
Text File  |  1992-09-18  |  95KB  |  1,663 lines

  1.                                                              
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                      PrintGL  1.26
  21.  
  22.                                   pen plotter emulator
  23.                                   for IBM/DOS systems
  24.  
  25.                       (C) Copyright Ravitz Software Inc. 1990,1992
  26.  
  27.  
  28.  
  29.             Ravitz Software Inc.                        BBS/FAX 606-268-0577
  30.             P.O. Box 25068
  31.             Lexington, KY  40524-5068
  32.             USA                            Compuserve Cary Ravitz [70431,32]
  33.  
  34.                                                                               
  35.  
  36.                                                                             p-1
  37.          Contents -------------------------------------------------------------
  38.  
  39.            Introduction ..................................................... 2
  40.            License and Registration                                           3
  41.            What Is New ...................................................... 4
  42.            Installation                                                       4
  43.            Operation ........................................................ 5
  44.            How To Get HP-GL Plotfiles From Your Graphics Software             6
  45.            Messages ......................................................... 6
  46.            Syntax                                                             7
  47.            Overview of Options .............................................. 8
  48.            /A - Location Option                                               8
  49.            /B - Tiling Option ............................................... 8
  50.            /C - Pen Color Option                                              9
  51.            /D - Output Destination Option ................................... 9
  52.            /F - Output Format Option                                         10
  53.            /I - Scaling Point Location Option .............................. 12
  54.            /J, /K - Printer Code Prefix, Suffix Options                      12
  55.            /L - Page Layout Option ......................................... 13
  56.            /M - Magnification Option                                         14
  57.            /N - Page Number Option ......................................... 14
  58.            /O - Origin and Orientation Option                                14
  59.            /P - Plotfile Option ............................................ 15
  60.            /Q - Number of Copies Option                                      15
  61.            /R - Internal Resolution Option ................................. 15
  62.            /S - Pen Shading Option                                           15
  63.            /T - Temporary File Option ...................................... 15
  64.            /W - Pen Width Option                                             16
  65.            /X - User Interface Options ..................................... 16
  66.            /Y - D/Y and S/E Switch Settings Option                           16
  67.            /Z - Chord Angle and Enhanced Font Option ....................... 17
  68.            PrintGL Menu Interface (PMI)                                      18
  69.            PMI Specific Functions .......................................... 18
  70.            PMI Input and Output Choices                                      19
  71.            PMI Plot Options ................................................ 19
  72.            PMI Pen Options                                                   19
  73.            PMI Page Layout Options ......................................... 20
  74.            PMI Other Options                                                 20
  75.            Large Paper ..................................................... 20
  76.            Tips On AutoCAD                                                   21
  77.            Answers ......................................................... 21
  78.            Useful Prefix and Suffix Codes                                    22
  79.            Display Output .................................................. 23
  80.            PostScript Output                                                 23
  81.            HP-GL and HP-GL/2 Output ........................................ 24
  82.            ZSoft PCX Bit Map Output                                          24
  83.            Printer Output .................................................. 25
  84.            Color Processing                                                  29
  85.            HP-GL Commands .................................................. 29
  86.            Compatibility and Technical Information                           30
  87.            User Support .................................................... 30
  88.                                                                               
  89.  
  90.                                                                             p-2
  91.          Introduction ---------------------------------------------------------
  92.  
  93.            PrintGL is a shareware pen plotter emulator for IBM/DOS systems.  It
  94.            prints or displays HP-GL (Hewlett-Packard Graphics Language  - 7475,
  95.            17440 subset) plotfiles on most PC graphics devices. HP-GL is widely
  96.            supported  by CAD,  drawing,  plotting, and other  graphics programs
  97.            including AutoCAD,  Microstation,  Generic  CADD,  MathCAD,  Schema,
  98.            OrCAD, and SAS.  PrintGL will print on Epson and IBM 9 pin printers,
  99.            Epson, Fujitsu, IBM, NEC, and Toshiba 24 pin printers,  HP LaserJet,
  100.            DeskJet, color  DeskJet,  PaintJet,  QuietJet, HP-GL/2 devices,  and
  101.            HP-GL plotters, IBM ExecJet,  Quietwriter 2 and 3, LaserPrinter, and
  102.            plotters,  Canon  LBP,  BJ,  and BJC  printers, Kodak  Color  4, PDP
  103.            ProTracer,  Tektronix  ColorQuick, and PostScript printers.  It will
  104.            also  display plots with a CGA, EGA, VGA, enhanced VGA, or HGC,  and
  105.            output  a ZSoft  PCX bit  map file or or  an Encapsulated PostScript
  106.            file with preview bit map.
  107.  
  108.            Even  if  your  graphics program supports  your  printer,  you  will
  109.            probably  find that PrintGL  is faster,  gives better print quality,
  110.            and/or  gives more  formatting flexibility.  PrintGL  uses  the best
  111.            graphics modes available for each printer that  it supports and uses
  112.            transfer  data compression  to improve print speed on many printers.
  113.            And it gives options  such as orientation, magnification,  position,
  114.            and pen  width, color, and  shading.  If  you need  printed graphics
  115.            output from personal software, you can output  HP-GL and use PrintGL
  116.            to do the printing.  This gives immediate support to a wide range of
  117.            printers.  And it lets you use the HP 17440 command  set while still
  118.            supporting lower function plotters.
  119.  
  120.            PrintGL interprets all of the  HP 7475 and 7440/17440 (ColorPro with
  121.            GEC)  command  set  that  is  applicable  to  plotfiles  except  for
  122.            character set 8 (Katakana).  None of the digitize, output, or device
  123.            control commands (except plotter on and off)  are supported as these
  124.            are only  used with direct control of a plotter.  And the error mask
  125.            command is not supported.  In addition to the HP 7475 and 7440/17440
  126.            commands, PrintGL handles paper feed, label  origin, and extra space
  127.            commands and proportional fonts.
  128.  
  129.            PrintGL can  be  run  from the DOS  command line (and .BAT files) or
  130.            from PrintGL Menu Interface (PMI). PMI is a menu driven program that
  131.            lets  you  choose  options,  select  a  list  of plotfiles,  and run
  132.            PrintGL.  This  simplifies the selection of options and lets you run
  133.            multiple plotfiles  without  intervention.  PMI  lets  you save five
  134.            configurations,  so after initial setup you can use it with  minimal
  135.            effort.
  136.  
  137.            This program is produced by a member of the Association of Shareware
  138.            Professionals (ASP).  ASP wants to  make  sure  that  the  shareware
  139.            principle  works   for  you.   If  you   are  unable  to  resolve  a
  140.            shareware-related  problem  with  an ASP  member  by  contacting the
  141.            member directly, ASP may be able to help. The ASP Ombudsman can help
  142.            you resolve a  dispute or problem  with an  ASP member, but does not
  143.            provide technical support for members' products. Please write to the
  144.            ASP  Ombudsman at  545  Grover Road,  Muskegon, MI 49442  or send  a
  145.            CompuServe message via CompuServe Mail to ASP Ombudsman 70007,3536.
  146.                                                                               
  147.  
  148.                                                                             p-3
  149.          License and Registration ---------------------------------------------
  150.  
  151.            PrintGL (including PrintGL Menu Interface) is provided as is.  There
  152.            are no warranties expressed or implied.
  153.  
  154.            PrintGL is copyrighted by Ravitz Software Inc.  You may copy PrintGL
  155.            only for use under this license agreement.
  156.  
  157.            PrintGL  is  distributed  as shareware.  You may use PrintGL without
  158.            charge on a trial basis to determine its suitability for you. If you
  159.            continue to  use it  after  your  evaluation, you  must  purchase  a
  160.            registered copy for $50.  This  registration covers  use by a single
  161.            person (on multiple computers) or installation  on a single computer
  162.            (may be used by a group of people).  There is no cost to use a later
  163.            1.** version after registering any 1.** version.
  164.  
  165.            You may distribute PrintGL  as a stand alone product if you keep the
  166.            entire   package   together,  unchanged,   including   this  license
  167.            explanation, and do not charge more than $10. You may not distribute
  168.            PrintGL as part of another product.
  169.  
  170.            To  purchase a registered copy of PrintGL,  send your name, address,
  171.            and $50 check to:
  172.  
  173.              Ravitz Software Inc.
  174.              P.O. Box 25068
  175.              Lexington, KY  40524-5068
  176.              USA
  177.  
  178.            You  will be sent  a printed  manual  and  disk (always  the  latest
  179.            version).  Specify  3.5  or  5.25  inch  disk.   If  you  previously
  180.            registered  PrintGL, you may send  $15  to  get a current  disk  and
  181.            manual.
  182.  
  183.            Multiuser licenses are $50 for the first copy (with disk and manual)
  184.            and thereafter  $40 per copy  with disk and manual or  $25  per copy
  185.            without disk or manual.
  186.  
  187.            For users outside the USA, please make checks payable in US dollars,
  188.            and except for  Canada,  please  use  a  check  from  a  US  bank if
  189.            possible. Don't forget to include your country in your address.
  190.  
  191.            If you register through a business, be sure to include your name.
  192.  
  193.            PrintGL Printer Driver is a special version of PrintGL, modified for
  194.            use as a  printer driver.  It may be licensed for  use in commercial
  195.            programs. Send a note to request more information on this.
  196.                                                                               
  197.  
  198.                                                                             p-4
  199.          What Is New ----------------------------------------------------------
  200.  
  201.            For version 1.26:
  202.              GEM IMG output (/FG) has been dropped
  203.              low resolution (180 dpi) Canon BJ, BJC drivers have been dropped
  204.              /FG drives the Pacific Data Products ProTracer
  205.              /FU is an improved HP LaserJet 2 driver
  206.              /F7+ is a two pass (double ink) BJ/ExecJet driver
  207.              /FB+ is a BJC driver with sparse line to line overlap
  208.              /FV* drives VESA EVGA 1024x768 displays
  209.              /FV+ (VESA EVGA 800x600) is fixed
  210.              /F0 drives any HP-GL/2 raster device
  211.              /F8 adds supports for the HP 7220
  212.              the PostScript XP macro (set via prefix code) sets the paper tray
  213.              the nominal resolution of PS, HP-GL, HP-GL/2 may be specified
  214.              line width N turns a pen off
  215.              the O suboption of /L has been dropped
  216.              pen overwrite mode (opaque pens) is the default
  217.  
  218.            For version 1.24:
  219.              multiple copies (/Q)
  220.              supports the Tektronix ColorQuick (/FR)
  221.              color 24 pin drivers use true black instead of CMY mix
  222.              PMI includes five configurations
  223.              revised shading patterns
  224.              reverse image is allowed on /F4, /FD, and /FL
  225.              PostScript output lets you set the nominal resolution
  226.              /DX1,..,/DX4 provide xon/xoff serial port drive
  227.              /DH1,..,/DH4 provide hardware handshaking serial port drive
  228.  
  229.            The latest version of PrintGL is available from the support bulletin
  230.            board at  606-268-0577  (1200..9600,N,8,1  24 hours/day,  XMODEM  or
  231.            YMODEM (1K XMODEM) download), packed in .ZIP format.
  232.  
  233.          Installation ---------------------------------------------------------
  234.  
  235.            Copy  the files PRINTGL.EXE and PMI.EXE  to  your  working  disk  or
  236.            directory. They are all that you need to run PrintGL.
  237.  
  238.            PRINTGL.EXE is the command line  driven executable file.  PMI.EXE is
  239.            the executable file for PrintGL Menu Interface. PMI needs to be able
  240.            to find  itself (PMI.EXE)  and PRINTGL.EXE,  so  both of these files
  241.            should be in a directory that is in your  DOS PATH.  If  you prefer,
  242.            you can set the environment  variable  PRINTGLP  to be a  path  that
  243.            tells PMI where to find itself and PRINTGL.EXE. If you have PRINTGLP
  244.            defined, PMI ignores the PATH.
  245.  
  246.            In addition to the above files, these files are part in the package,
  247.            and must be included if you distribute PrintGL as shareware:
  248.  
  249.              PRINTGL.DOC  documentation
  250.              ADD.DOC      additional documentation since last release
  251.              HPGL.DOC     HP-GL reference
  252.              HPGL.CHR     HP-GL character set plotfile
  253.              SAMPLE.PLT   sample plotfile
  254.              ORDER.FRM    order form
  255.              README.*     quick information
  256.                                                                               
  257.  
  258.                                                                             p-5
  259.          Operation ------------------------------------------------------------
  260.  
  261.            PrintGL reads a plotfile, does arc,  character, fill, etc.  to  line
  262.            conversion,  stores the data in  a  coordinate list, and  if needed,
  263.            puts the list on disk. It then reorients the data and determines the
  264.            plot size. Next the data is resized and relocated. For vector output
  265.            formats (HP-GL, PostScript) data is output from here. For bit mapped
  266.            devices  (most printers, displays, bit maps) the coordinate list  is
  267.            rasterized and output in swaths.  You are likely to  see the printer
  268.            print a swath and stop while PrintGL is processing the next swath.
  269.  
  270.            Esc  stops PrintGL at the next good break point, leaving the printer
  271.            ready for new data. Ctrl-Break stops PrintGL as quickly as possible.
  272.            You generally need to do a printer reset after a Ctrl-Break.
  273.  
  274.            When you  display a  plot, press Enter or  Esc  to return to the DOS
  275.            text screen,  or  any  of  the four  cursor movement  keys to scroll
  276.            across the plot.  Press S to cycle between full, half (the default),
  277.            quarter, and eighth page scrolling.
  278.  
  279.            PrintGL works within a printer's current margins  and starts at  the
  280.            current  vertical print  position.  If  you decline  the  form  feed
  281.            suboption  of the  /L option then PrintGL leaves the  printer at the
  282.            start of the  line directly below the plot.  All printing is done in
  283.            printer lines that cover the full height of the printhead.
  284.  
  285.            PrintGL will not automatically change a printer's operating mode. On
  286.            multimode  printers, the  right  operating  mode must be  set before
  287.            running PrintGL or with the prefix code (/J) option.
  288.  
  289.            Internally PrintGL  uses two byte  coordinates  on  a 1016 dots/inch
  290.            grid. This allows for plots with coordinates of over 30 inches - far
  291.            larger than an HP 7475 can handle. However, if you are using PrintGL
  292.            to emulate a large plotter, you may overflow the internal coordinate
  293.            system.  This condition  is  not checked, and  it will cause garbage
  294.            output.  You can change the internal resolution to 508 dots per inch
  295.            (giving 60 inch maximum plot sizes) with the /R option (/R508). This
  296.            only helps  store the  original plot  internally.  The  next step in
  297.            PrintGL converts  these  coordinates  to the  requested size  in the
  298.            resolution of the output device, and these coordinates must also fit
  299.            in the two byte coordinate list.
  300.                                                                               
  301.  
  302.                                                                             p-6
  303.          How To Get HP-GL Plotfiles From Your Graphics Software ---------------
  304.  
  305.            To use PrintGL, you must be  able  to  output HP-GL files  from your
  306.            graphics application.  Most CAD, drawing, and graphing software lets
  307.            you do this.  Just tell the application to output your  picture to a
  308.            plotter.  In either the configuration process or the output process,
  309.            you will need to specify that:  you have an HP 7475 or HP 7440/17440
  310.            plotter;  and that you want the output to go to a file instead  of a
  311.            COM port (some programs name the file automatically and some ask you
  312.            for a name).  Once you have the file, you can print it with PrintGL,
  313.            either from a DOS shell or after exiting the application.
  314.  
  315.          Messages -------------------------------------------------------------
  316.  
  317.            PrintGL  displays a number of messages to  keep you informed of what
  318.            it is doing. The output looks like this.
  319.  
  320.              Reading SAMPLE.PLT
  321.              Plotfile has 1 page(s)    Processing page 1    2283 data records
  322.              Overall magnification    0.9964
  323.              Print window   Horizontal   0.00   7.54    Vertical   0.00  10.14
  324.              Plot area      Horizontal   0.42   7.13    Vertical   0.61   9.54
  325.              Output format /FT  HxV dpi nominal 180x180, actual 180x180  color
  326.              Writing to device LPT3
  327.  
  328.            The first  line  is the plotfile  that is currently being processed.
  329.            The second line tells how many pages are in the plotfile, which page
  330.            is being processed, and the number of data points in that page.  The
  331.            number of  data points  is roughly  equivalent  to the number of pen
  332.            moves and  is  shown  to  give  you  an  indication  of  the  plot's
  333.            complexity.
  334.  
  335.            The  overall magnification is  either  the  magnification  that  you
  336.            specified  with the /M option or the  effective  magnification after
  337.            fitting to the print  window with /MF.  The  print window line gives
  338.            the horizontal  and vertical coordinates of the print window, always
  339.            starting  at 0,0 and in inches.  The plot area  gives the horizontal
  340.            and vertical coordinates of a box that just covers the plotted data.
  341.            This uses the same coordinate system as the print window, so you can
  342.            tell where the plot is relative to the print window.
  343.  
  344.            The  output  format  and resolution are given and  then  the  output
  345.            destination is noted (except for screen plots). If three plane color
  346.            is being used, the word  "color" is displayed.  If you  have a black
  347.            only  printer, but  the  output format  allows color (this is common
  348.            with 9 and 24 pin printers), using color will triple the PrintGL run
  349.            time with no improvement in print quality.
  350.  
  351.            During  processing, PrintGL informs  you when  it is  processing and
  352.            writing data,  and you can watch the progress from 0% to 100%, along
  353.            with the elapsed time.
  354.                                                                               
  355.  
  356.                                                                             p-7
  357.          Syntax ---------------------------------------------------------------
  358.  
  359.            The calling syntax of PrintGL is:
  360.  
  361.              PRINTGL plotfile /option1 /option2 ...
  362.  
  363.            Spaces between parameters  are  not required.  The  plotfile  may be
  364.            specified with  the /P option if it  is inconvenient to make it  the
  365.            first parameter.
  366.  
  367.            If a given option is entered more  than once, only the last entry is
  368.            used.  And if  an  option  is invalid  (but  not  incorrect),  it is
  369.            ignored.  This  lets  you set  up a  batch  file with your preferred
  370.            options  but override them as desired.  For example,  create PHP.BAT
  371.            with the line:
  372.  
  373.              PRINTGL /FL /M1 /P %1 %2 %3 %4 %5 %6 %7 %8 %9
  374.  
  375.            Then  PHP can be called just  like PRINTGL  but  it  defaults to  HP
  376.            LaserJet format with magnification 1.
  377.  
  378.            The DOS environment variable PRINTGL  is examined by PrintGL and  if
  379.            it  is  nonblank  then  it  is  put  in  front  of  the command line
  380.            parameters.  If you  put "SET PRINTGL=/FL/M1"  in your  AUTOEXEC.BAT
  381.            then  PrintGL will default to LaserJet format with  magnification 1.
  382.            This is ignored when running under PrintGL Menu Interface.
  383.  
  384.            If you do not enter any parameters or if any parameter is incorrect,
  385.            PrintGL displays its option reminder screen.
  386.  
  387.            Below, [ and ] enclose optional suboptions  and | separates mutually
  388.            exclusive suboptions. The options and suboptions may be in any order
  389.            except  that multiple numeric suboptions  are  ordered  and  numeric
  390.            suboptions must follow character suboptions where the characters may
  391.            be digits.  "c"  refers to  a  suboption character,  "x"  and "y" to
  392.            suboption  numbers,  "i"  and "j"  to  suboption  integers, "b" to a
  393.            suboption byte, and "f" to a DOS file or device name.
  394.  
  395.            For  numbers (x, y), a decimal point is allowed but is not required,
  396.            and scientific notation is not allowed.  "-" is allowed but not "+".
  397.            For  integer input (i, j), only  base  ten integers  from  -32768 to
  398.            32767 are allowed. "+" is not allowed. A byte (b) must be a base ten
  399.            integer  from  0 to 255 or a hexadecimal number prefixed with $ from
  400.            $00 to $FF.  Further range checking is done for most options to flag
  401.            unreasonable  input.  If an option  has multiple numeric suboptions,
  402.            these may be separated with commas or blanks.
  403.  
  404.            ********************************************************************
  405.  
  406.            It  is very important to choose the right output format (/F option).
  407.            It is likely  that  the  default  output  format will  work on  your
  408.            printer, but it is equally likely  that it  will not produce optimal
  409.            results.  Please look carefully at the entire list of output formats
  410.            before  choosing one, and do not assume that because a  format works
  411.            that it is the best one to use.
  412.  
  413.            ********************************************************************
  414.                                                                               
  415.  
  416.                                                                             p-8
  417.          Overview of Options --------------------------------------------------
  418.  
  419.            PrintGL's options fall into several categories.  The  first is input
  420.            and output choices.  The  input is chosen with /P, the plotfile, and
  421.            /N,  the  page number.  Output options  are  /F,  the output  format
  422.            (printer model), and /D, the destination port, device, or file.
  423.  
  424.            The  second category is the  page layout.  /L controls  the size and
  425.            location of the  print window (hard clip  limits), and the option to
  426.            box  the window, send  a form feed, reverse the image color, and use
  427.            opaque lines. Tiling is set with /B and copies with /Q.
  428.  
  429.            The third category  defines  how  the  plot  looks  within the print
  430.            window.  /M,  the  magnification, sets the  size  of  the  plot.  /A
  431.            determines the location of the plot within the print window. /O sets
  432.            the  origin and orientation, and  is  used to  rotate  or mirror the
  433.            plot. /I sets the plotter's initial scaling points.
  434.  
  435.            The  fourth category defines the pens, /W for the width,  /C for the
  436.            color, and /S for the shade.
  437.  
  438.            And  the last category determines  how  PrintGL processes  the plot.
  439.            This includes the  temporary  file /T, the default and minimum chord
  440.            angle /Z, the  plotter Y/D and S/E switch position  /Y, the internal
  441.            resolution  /R, user interface options /X, and /J and /K let you set
  442.            up and reset the printer for special situations.
  443.  
  444.          /A - Location Option -------------------------------------------------
  445.  
  446.            /A[O][x,y] - location - default /A
  447.  
  448.            The A option determines the location of the plot in the print window
  449.            via  a point on  the plot that  is aligned with a point in the print
  450.            window.  You can specify the plot alignment point with x,y in inches
  451.            from the plot's  origin  (before  PrintGL applies magnification), or
  452.            let  it default to the plot  center.  For the print window alignment
  453.            point, you can default to the center or specify the origin with O.
  454.  
  455.            /A      puts the center of the plot at the center of the print
  456.            /AO0,0  puts the plot 0,0 at the print window origin
  457.  
  458.          /B - Tiling Option ---------------------------------------------------
  459.  
  460.            /B[i,j,x] - tiling parameters - default /B1,1,0
  461.  
  462.            /B lets  you specify tiling  options that break  a large  plot  into
  463.            pages.  Each page is defined by the page layout option (/L). I and j
  464.            specify the number of tiles  (pages) horizontally and vertically.  X
  465.            specifies the overlap in inches.  Displayed plots are sized based on
  466.            the  tiling, but  only the first tile is displayed.  Use  the cursor
  467.            keys to scroll the plot.
  468.  
  469.            /B2,2,.5  breaks the plot into 4 pages with .5 inch overlap
  470.            /B        is the same as /B1,1,0 and produces no tiling
  471.                                                                               
  472.  
  473.                                                                             p-9
  474.          /C - Pen Color Option ------------------------------------------------
  475.  
  476.            /C[O|T]c.. - color - default /CK
  477.  
  478.            /C specifies the color of each pen. The colors are B for blue, C for
  479.            cyan,  G  for green, K  for black, M for magenta, R for  red,  W for
  480.            white, and Y for  yellow.  Unspecified  pens use the  last  selected
  481.            color (/CRGB is  the same as /CRGBBBBBB).  If the output format does
  482.            not allow color then nonwhite colors are changed to black.
  483.  
  484.            Additional colors can be created with shade mixing. These colors use
  485.            shading patterns  to  mix  the  eight pure colors.  The format for a
  486.            mixed color is  .??  where each ?  represents any of  the eight pure
  487.            colors.  The first  color is printed  with the pen's shading pattern
  488.            (/S option)  and the  second  is printed  with  the  inverse shading
  489.            pattern.  If  the shade value is  0 (solid) it is replaced by 2 (one
  490.            dot checkerboard) which produces the most uniform mixed colors.
  491.  
  492.            Mixed  colors need line widths of  at  least 2 (4  for 2 dot shading
  493.            patterns) to look  good, and they may have visual artifacts on edges
  494.            near a 45 degree angle.
  495.  
  496.            By default, colors  are overwritten  into the print, so they  appear
  497.            opaque.  You can  switch to translucent colors (ored into the print)
  498.            with the T suboption, and then back to opaque with the  O suboption.
  499.            Make  this mode switch in front  of the pen that you want to change.
  500.            For PostScript devices and plotters, the color processing is done by
  501.            the device, not PrintGL.  PostScript devices use  opaque  colors and
  502.            plotters use translucent colors.
  503.  
  504.            " means repeat the previous color.
  505.  
  506.            /CK             sets pen 1..40 to black
  507.            /CKOR.MB""T.KY  sets pen 1     to black
  508.                                 pen 2     to opaque red
  509.                                 pen 3..5  to opaque magenta on blue
  510.                                 pen 6..40 to translucent black on yellow
  511.  
  512.          /D - Output Destination Option ---------------------------------------
  513.  
  514.            /D[+]f - destination - default /D1
  515.  
  516.            The D option specifies the output printer port, device, or file. The
  517.            + suboption causes files to be appended rather  than overwritten (it
  518.            has no effect on device output). 1, 2, and 3 select the BIOS printer
  519.            routines.  X1, X2, X3, and X4 select xon/xoff controlled serial port
  520.            drive.  H1,  H2, H3, and H4 select hardware controlled  serial  port
  521.            drive. You can also use the DOS devices LPT1, COM1, etc.
  522.  
  523.            PrintGL cannot set up the serial ports.  This is usually done in the
  524.            AUTOEXEC.BAT with MODE (probably MODE COM1:9600,N,8,1,P).
  525.  
  526.            /D is ignored for display output.
  527.  
  528.            /D2          sends output to the second parallel port via BIOS
  529.            /DLPT3       sends output to the DOS device LPT3
  530.            /D+TEMP.PRN  appends output to file TEMP.PRN
  531.                                                                               
  532.  
  533.                                                                            p-10
  534.          /F - Output Format Option --------------------------------------------
  535.  
  536.            /Fc[-|+|*][!][~][`][x,y] - output format - default /FN~
  537.  
  538.            The F option specifies the output format. -, +, and * are resolution
  539.            modifiers, !  selects a compression  mode driver, ~ turns  off color
  540.            processing,  and  `  turns off  four plane  color processing.  These
  541.            suboptions are allowed even if they have no effect.
  542.  
  543.            For 800x600 VGA (/FV+) you can append the display mode number.  This
  544.            must follow the format character.  It may be entered in hex with a $
  545.            prefix.  For PostScript  (/FS) and HP-GL/2 (/F0) you  can append the
  546.            nominal device resolution.  Matching  the nominal  resolution to the
  547.            printer may yield small improvements in print quality.
  548.  
  549.            You can append the horizontal and vertical resolution of  the output
  550.            device  in  dots/inch.  This  overrides  the  normal  output  device
  551.            resolution, but does  not affect the structure of the output.  These
  552.            numbers should follow  all other suboptions.  In addition to letting
  553.            you choose  any  resolution for a  bit  map, this  feature lets  you
  554.            compensate for print size error.  For example, a 360x360 dpi printer
  555.            consistently  under indexes so that a 6 inch high box comes out 5.94
  556.            inches. Using 360,363.6 (6/5.94*360 = 363.6) removes the error.  For
  557.            print size correction, you also  specify a number from .5 to 2 which
  558.            is  interpreted  as  the nominal  resolution  time this number.  For
  559.            example on a 360 dpi printer, 1.0,1.01 is the same as 360,363.6.
  560.  
  561.            Drivers marked below with ! have a compression mode driver, selected
  562.            with "!".  This may be  very useful, but it depends on your printer.
  563.            These  drivers compress the  output data by breaking  bit map strips
  564.            with printhead positioning commands.  This  saves data  transmission
  565.            time, but some  printers spend more  time positioning the  printhead
  566.            than is saved by not sending the data.
  567.  
  568.            A  number of  printers use  compression  mode by default.  It can be
  569.            turned off with ¡ (ASCII 173).
  570.  
  571.            Drivers marked below with  ~  are color devices.  Using ~ suppresses
  572.            color processing, substituting  black for  all colors  except white.
  573.            The ` suboption switches from 4 plane  color  to  3  plane color, so
  574.            CMYK devices become CMY and RGBI devices become RGB.
  575.  
  576.            /F0     ~ HP-GL/2 ......................................... 600x600
  577.            /F0i    ~ HP-GL/2                                             ixi
  578.            /F1     ~ IBM 9 pin ....................................... 120x72
  579.            /F1+    ~ IBM 9 pin (2 pass)                                120x144
  580.            /F1*    ~ IBM 9 pin (4 pass) .............................. 240x144
  581.            /F2       IBM Quietwriter 2                                 240x240
  582.            /F3       IBM Quietwriter 3 ............................... 240x240
  583.            /F4-      IBM LaserPrinter (PPDS mode)                      150x150
  584.            /F4       IBM LaserPrinter (PPDS mode) .................... 300x300
  585.            /F5    !~ IBM 24 pin alternate 1                            180x180
  586.            /F5+   !~ IBM 24 pin alternate 1 (2 pass) ................. 360x180
  587.            /F5*   !~ IBM 24 pin alternate 1 (4 pass)                   360x360
  588.            /F6    !  IBM Proprinter X24 .............................. 180x182
  589.            /F6+   !  IBM Proprinter X24 (2 pass)                       360x182
  590.            /F6*   !  IBM Proprinter X24 (4 pass) ..................... 360x364
  591.                                                                               
  592.  
  593.                                                                            p-11
  594.            /F7       Canon BJ (Proprinter mode), IBM ExecJet ......... 360x360
  595.            /F7+      Canon BJ (Proprinter mode), IBM ExecJet (2 pass)  360x360
  596.            /F8       HP-GL .......................................... 1016x1016
  597.            /F8i      HP-GL enhanced (7550 enhanced mode)                 ixi
  598.            /F9    !~ NEC 24 pin ...................................... 180x180
  599.            /F9+   !~ NEC 24 pin (2 pass)                               360x180
  600.            /F9*   !~ NEC 24 pin (4 pass) ............................. 360x360
  601.            /FA-    ~ HP DeskJet 500C, Mannesmann Tally MT92C           150x150
  602.            /FA     ~ HP DeskJet 500C, Mannesmann Tally MT92C ......... 300x300
  603.            /FB     ~ Canon BJC 800                                     360x360
  604.            /FB+    ~ Canon BJC 800 (line overlap) .................... 360x360
  605.            /FC       CGA display                                        62x25
  606.            /FD-      Canon LBP (ISO mode) ............................ 150x150
  607.            /FD       Canon LBP (ISO mode)                              300x300
  608.            /FE     ~ 128K EGA color display ........................... 62x45
  609.            /FF    !~ Fujitsu 24 pin                                    180x180
  610.            /FF+   !~ Fujitsu 24 pin (2 pass) ......................... 360x180
  611.            /FF*   !~ Fujitsu 24 pin (4 pass)                           360x360
  612.            /FG       PDP Protracer (Proprinter mode) ................. 360x360
  613.            /FH       Hercules graphics card display                     70x45
  614.            /FI-      HP LaserJet 3, DeskJet .......................... 150x150
  615.            /FI       HP LaserJet 3, DeskJet                            300x300
  616.            /FJ       Canon BJ (BJ130 mode) ........................... 360x360
  617.            /FK     ~ Kodak Diconix Color 4                             192x192
  618.            /FL-      HP LaserJet ..................................... 150x150
  619.            /FL       HP LaserJet                                       300x300
  620.            /FM       128K EGA monochrome display .....................  62x45
  621.            /FN     ~ Epson 9 pin                                       120x72
  622.            /FN+    ~ Epson 9 pin (3 pass) ............................ 120x216
  623.            /FN*    ~ Epson 9 pin (6 pass)                              240x216
  624.            /FO    !~ Toshiba 24 pin .................................. 180x180
  625.            /FO+   !~ Toshiba 24 pin (2 pass)                           360x180
  626.            /FO*   !~ Toshiba 24 pin (4 pass) ......................... 360x360
  627.            /FP    !~ HP PaintJet                                       180x180
  628.            /FQ       HP QuietJet (PCL mode) .......................... 192x192
  629.            /FR     ~ Tektronix ColorQuick                              216x216
  630.            /FS     ~ PostScript ...................................... 600x600
  631.            /FSi    ~ PostScript                                          ixi
  632.            /FT    !~ Epson 24 pin .................................... 180x180
  633.            /FT+   !~ Epson 24 pin (2 pass)                             360x180
  634.            /FT*   !~ Epson 24 pin (4 pass) ........................... 360x360
  635.            /FU-      HP LaserJet 2                                     150x150
  636.            /FU       HP LaserJet 2 ................................... 300x300
  637.            /FV     ~ VGA display                                        62x62
  638.            /FV+    ~ VESA 800x600 VGA display ......................... 78x78
  639.            /FV+b   ~ 800x600 VGA display - mode b                       78x78
  640.            /FV*    ~ VESA 1024x768 VGA display ....................... 100x100
  641.            /FW     ~ Epson 9 pin alternate                             120x72
  642.            /FW+    ~ Epson 9 pin alternate (3 pass) .................. 120x216
  643.            /FW*    ~ Epson 9 pin alternate (6 pass)                    240x216
  644.            /FX    !~ IBM 24 pin alternate 2 .......................... 180x180
  645.            /FX+   !~ IBM 24 pin alternate 2 (2 pass)                   360x180
  646.            /FX*   !~ IBM 24 pin alternate 2 (4 pass) ................. 360x360
  647.            /FY       append Encapsulated PostScript preview bit map     72x72
  648.            /FYi,j    append Encapsulated PostScript preview bit map .... ixj
  649.            /FZ     ~ ZSoft PCX                                         100x100
  650.            /FZi,j  ~ ZSoft PCX ......................................... ixj
  651.                                                                               
  652.  
  653.                                                                            p-12
  654.          /I - Scaling Point Location Option -----------------------------------
  655.  
  656.            /IA|R|W[N] - IP point location - default /IA
  657.  
  658.            This option is not useful with any HP-GL that does not use the scale
  659.            command or that initializes the plotter or sets the scaling points.
  660.  
  661.            The  I option  sets the initial scaling points (P1, P2 - the scaling
  662.            points  may  be set  in  the HP-GL  file  with  the IP  command).  A
  663.            (absolute) sets the points  to the default  for  the paper size (see
  664.            below).  R fits P1 and P2 to the print window with at least .25 inch
  665.            margins  and an x/y ratio of 10/7.2 (the same ratio as  the HP  7475
  666.            with small paper).  W fits P1 and P2  to the print window with a .25
  667.            inch margin. N makes the margin 0 for R or W and is ignored with A.
  668.  
  669.            The  default scaling points depend on the print window  (/L  option)
  670.            with the implied paper size and the plot orientation (/O option).
  671.  
  672.            paper    options            default scaling pts  with RO90 command
  673.            7440 A   /O1 /L 7.54,10.14  250,279 10250, 7479  279,250  7479,10250
  674.            7440 A4  /O1 /L 7.54,10.74  250,279 10250, 7479  279,250  7479,10250
  675.            7475 A4  /O1 /L 7.84,10.20  250,596 10250, 7796  154,244  7354,10244
  676.            7475 A4  /O1 /L 7.60,10.88  603,521 10603, 7721    0,610  7200,10610
  677.            7475 B   /O1 /L10.20,16.38  522,259 15722,10259  283,934 10283,16134
  678.            7475 A3  /O1 /L10.88,15.90  170,602 15370,10602  607,797 10607,15997
  679.            7440 A   /O2 /L10.14, 7.54  250,279 10250, 7479  279,250  7479,10250
  680.            7440 A4  /O2 /L10.74, 7.54  250,279 10250, 7479  279,250  7479,10250
  681.            7475 A   /O2 /L10.20, 7.84  250,596 10250, 7796  154,244  7354,10244
  682.            7475 A4  /O2 /L10.88, 7.60  603,521 10603, 7721    0,610  7200,10610
  683.            7475 B   /O2 /L16.38,10.20  522,259 15722,10259  283,934 10283,16134
  684.            7475 A3  /O2 /L15.90,10.88  170,602 15370,10602  607,797 10607,15997
  685.  
  686.            anything else               250,279 10250, 7479  279,250  7479,10250
  687.  
  688.            /O3 and /O4 gives the same default scaling points as /O1 and /O2.
  689.  
  690.            /IA   uses the default scaling points
  691.            /IWN  sets the scaling points to fit the print window
  692.  
  693.          /J, /K - Printer Code Prefix, Suffix Options -------------------------
  694.  
  695.            /J[b,b,..] - printer code prefix - default /J
  696.            /K[b,b,..] - printer code suffix - default /K
  697.  
  698.            /J lets you send codes to the printer before PrintGL's usual data is
  699.            sent and /K  lets you send codes after PrintGL's usual data is sent.
  700.            This lets you set up and reset the  printer for special  situations.
  701.            For  plotter   and  PostScript  output,  the  /J  codes  follow  the
  702.            initialization commands.
  703.  
  704.            The  codes  are  specified  with  byte  values  (0..255  or $0..$FF)
  705.            separated with blanks or commas.  There is  a limit of 80 characters
  706.            for any option, so very long  sequences must  be handled outside  of
  707.            PrintGL.
  708.  
  709.            /J27 79   sets skip perforation off  to allow plots  larger than one
  710.                      page on most continuous form printers
  711.                                                                               
  712.  
  713.                                                                            p-13
  714.          /L - Page Layout Option ----------------------------------------------
  715.  
  716.            /L[B][F][R][x,y[,x,y]] - page layout - default depends on printer
  717.  
  718.            The L option defines the page layout.
  719.  
  720.            B boxes the plot at the print window edge using pen 40.
  721.  
  722.            F and N set form feed or no form feed.  Form feed is the default and
  723.            does not need  to be specified.  This is ignored for PCX and display
  724.            output.
  725.  
  726.            R reverses the colors on displays,  bit maps,  and output formats 4,
  727.            D,  and  L, (Canon,  HP, and  IBM laser  printers) and  is otherwise
  728.            ignored. This gives the equivalent of a photographic negative.
  729.  
  730.            The first optional x and y are the print window width and height  in
  731.            inches.  These  define the hard clip limits.  These  values are  not
  732.            checked against the printer's capabilities.  If you specify  a print
  733.            window  that  exceeds the  output  device  limits,  the  results are
  734.            unknown.  You may need to reset the printer's margins or page length
  735.            for large plots (see Large Paper). The size needed for a given width
  736.            and height exceeds x and y by 8 dots to allow for line widths.
  737.  
  738.            The  second optional x and y are the left and  top margins, measured
  739.            from the  printer's left margin and current vertical position to the
  740.            print window. The margins for HP-GL and PostScript are measured from
  741.            0,0 (left, bottom).  Margins are ignored for  display output and bit
  742.            maps.
  743.  
  744.            THE PRINT WINDOW PLUS MARGINS MUST FIT WITHIN THE PRINTABLE AREA.
  745.  
  746.            Each printer has a default page layout.  The default print window is
  747.            7.54x10.14 for printers and bit maps  and  10.14x7.54 for  HP-GL and
  748.            displays.  These correspond to HP 7440 A size paper. The margins are
  749.            printer  specific  to compensate for different  paper  handling.  In
  750.            evaluating  user  options, PrintGL  processes each  option and  when
  751.            finished  reprocesses the default page layout for the chosen printer
  752.            and  then reprocesses the last user /L option.  This procedure gives
  753.            good  default values  so that your /L option can  change the  letter
  754.            suboptions while keeping the default print window.
  755.  
  756.            /LB7.5,3,.5,0   makes the  print window 7.5 inches wide and 3 inches
  757.                            high,  with a .5 inch left margin and no top margin,
  758.                            boxes the window, and does not do a form feed
  759.            /LF7.54,10.14   sets window equivalent to HP 7440 with A  paper
  760.            /LF7.54,10.74   sets window equivalent to HP 7440 with A4 paper
  761.            /LF7.84,10.20   sets window equivalent to HP 7475 with A  paper
  762.            /LF7.60,10.88   sets window equivalent to HP 7475 with A4 paper
  763.            /LF10.20,16.38  sets window equivalent to HP 7475 with B  paper
  764.            /LF10.88,15.90  sets window equivalent to HP 7475 with A3 paper
  765.                                                                               
  766.  
  767.                                                                            p-14
  768.          /M - Magnification Option --------------------------------------------
  769.  
  770.            /M[F]x - magnification - default /MF.9
  771.  
  772.            The M option specifies the magnification.  F fits the  plot  to  the
  773.            print window size.  The default is /MF.9 which makes the plot 90% of
  774.            the largest size that will  fit in the print  window.  /M1 gives the
  775.            same size plot as an HP 7475 plotter.
  776.  
  777.            /MF.9  fits the plot to the print window and shrinks it 10%
  778.            /M1    plots at the same size as an HP 7475
  779.            /M.5   plots at half the size of an HP 7475
  780.  
  781.          /N - Page Number Option ----------------------------------------------
  782.  
  783.            /N[i] - page number - default /N
  784.  
  785.            /Ni says to print only page i of the plotfile. If you do not specify
  786.            i then all pages in the plot will be printed (this is the default).
  787.  
  788.            /N   prints all pages in the plotfile
  789.            /N3  prints only page 3
  790.  
  791.          /O - Origin and Orientation Option -----------------------------------
  792.  
  793.            /O[1|2|3|4[L]] - origin, orientation - default /O
  794.  
  795.            The O  option  sets  the print  window origin  and orientation.  The
  796.            origin  is  one of four corners numbered 1..4  for upper left, lower
  797.            left, lower right, and upper right, and implies a plot rotation. The
  798.            L suboption specifies a left handed coordinate system, which mirrors
  799.            the plot.  If no origin is specified then it is chosen so that the x
  800.            axis is the longer dimension.
  801.  
  802.            Here are pictures of PrintCAD's view of the output media compared to
  803.            an HP 7475's view.
  804.  
  805.            HP 7475                               PrintGL
  806.                                                                display or
  807.            A size           B size               printer       plotter
  808.  
  809.              y┌────────┐    0,0┌────────┐y       ul ┌─────┐ur   ul ┌────────┐ur
  810.               │        │       │        │         1 │     │4     1 │        │4
  811.               │        │       │        │           │     │        │        │
  812.            0,0└────────┘x      │        │           │     │     ll └────────┘lr
  813.                                │        │           │     │      2           3
  814.                                │        │        ll └─────┘lr
  815.                                │        │         2        3
  816.                               x└────────┘
  817.  
  818.            /O1  puts the print window's origin in the upper left corner
  819.            /O2  puts the print window's origin in the lower left corner
  820.                                                                               
  821.  
  822.                                                                            p-15
  823.          /P - Plotfile Option -------------------------------------------------
  824.  
  825.            /Pf - plotfile - no default
  826.  
  827.            The plotfile may be specified as the first parameter with no prefix,
  828.            or  it may be specified anywhere in the option list with /P.  If you
  829.            use a  file name  mask with "*"  and/or  "?",  each matching file is
  830.            processed, but the first failure or user break stops all processing.
  831.  
  832.          /Q - Number of Copies Option -----------------------------------------
  833.  
  834.            /Qi - number of copies - default /Q1
  835.  
  836.            /Q  sets the number of copies of  each printed page.  The default is
  837.            one.  Page printers  produce multiple  copies  faster using  the  "N
  838.            copies" prefix code (see Useful Prefix and Suffix Codes).
  839.  
  840.          /R - Internal Resolution Option --------------------------------------
  841.  
  842.            /Ri - internal resolution - default /R1016
  843.  
  844.            /R sets the internal grid resolution  in dots/inch.  It is  normally
  845.            1016 and rarely needs  to be changed.  To fit very large plots  into
  846.            the   -32768..32767  coordinate  limit,  use   /R508.   Setting  the
  847.            resolution to a multiple  of the output device  resolution times the
  848.            magnification may yield a small improvement in print quality.
  849.  
  850.          /S - Pen Shading Option ----------------------------------------------
  851.  
  852.            /Sc.. - pen shading patterns - default /S0
  853.  
  854.            /S assigns a shading pattern  to each pen.  Unspecified pens use the
  855.            last specified shade.  The shade values  are 0..8.  0 is the default
  856.            solid line.  1..4 are 1 dot patterns (75%, 50%, 25%, 12.5%) and need
  857.            line  widths of at least three to give good looking lines.  5..8 are
  858.            2x2 dot patterns (75%,  50%,  25%, 12.5%) and need line widths of at
  859.            least five to give good looking lines. Some printers, especially dot
  860.            matrix printers  in  multipass modes,  may wash  out shading because
  861.            they have a dot size that is large relative to the dot spacing.
  862.  
  863.              1     2     3     4       5         6         7         8
  864.              █▀█▄  ▀▄▀▄  ▀▄       ▀    ██████    ██  ██    ██              ██
  865.              ▀█▄█  ▀▄▀▄    ▄▀   ▀      ██  ████    ██  ██    ██
  866.              █▀█▄  ▀▄▀▄  ▀▄       ▀    ████  ██  ██  ██          ██    ██
  867.              ▀█▄█  ▀▄▀▄    ▄▀   ▀        ██████    ██  ██      ██
  868.  
  869.            /S024  sets pen 1 to solid, pen 2 to 50%, pen 3..40 to 12.5%
  870.  
  871.          /T - Temporary File Option -------------------------------------------
  872.  
  873.            /T[+]f - temporary file - default /TPLOT.TMP
  874.  
  875.            PrintGL uses a temporary  file when  there is not  enough  memory to
  876.            handle a plotfile.  You can use /T to put it on a RAM disk for extra
  877.            speed.  You can force  the use of a temporary file,  if the plot has
  878.            over 1024 data points, with +.  If you use a RAM disk this may speed
  879.            printing.
  880.                                                                               
  881.  
  882.                                                                            p-16
  883.          /W - Pen Width Option ------------------------------------------------
  884.  
  885.            /Wc.. - pen widths - default /WA
  886.  
  887.            The W option assigns pen line widths. Each width may be 0..9, .10 ..
  888.            .16 dots, A..I for 2..10 units of 4/1016 inch  (.1 mm), or N to turn
  889.            off  the pen.  A..I widths are approximations, based on  the  device
  890.            technology. Unassigned pens use the last assigned width.
  891.  
  892.            For nonsquare matrix printers, PrintGL uses pen points optimized for
  893.            an h/v ratio of .67, 1, or 1.5.  Widths are figured in the direction
  894.            of higher resolution, and are not accurate in the other direction.
  895.  
  896.            Line  widths  of over eight dots are slightly distorted at the print
  897.            window edge to fit within the four dot border.
  898.  
  899.            /WA      sets pens 1..40 to .2 mm
  900.            /WB2.16  sets pen 1 to .3 mm, pen 2 to 2 dots, pens 3..40 to 16 dots
  901.  
  902.          /X - User Interface Options ------------------------------------------
  903.  
  904.            /X[C][P][S][F][U] - interface options - default /X
  905.  
  906.            The X option sets various interface options. C causes a break when a
  907.            plot is clipped. P causes a pause before each printed page.
  908.  
  909.            S suppresses  location and  size messages.  F  suppresses  location,
  910.            size, file name, and page number messages.  U suppresses unsupported
  911.            command and incorrect number messages.
  912.  
  913.            /XS  gives only the most important messages
  914.  
  915.          /Y - D/Y and S/E Switch Settings Option ------------------------------
  916.  
  917.            /Y[D|Y][S|E] - D/Y and S/E switch setting - default /YDS
  918.  
  919.            The Y option sets the plotter's D/Y  switch to  D  or Y and the  S/E
  920.            switch to S or  E.  Y starts  with the  plotter off and responds  to
  921.            esc.(, esc.Y, esc.), and esc.Z commands.  D  starts with the plotter
  922.            on and ignores these commands. S sets the standard interpretation of
  923.            IW (clipping window) commands.  E sets 7550 enhanced  interpretation
  924.            of IW commands, so that they use scaled coordinates.
  925.  
  926.            /YD  puts the YD switch in the usual D position
  927.                                                                               
  928.  
  929.                                                                            p-17
  930.          /Z - Chord Angle and Enhanced Font Option ----------------------------
  931.  
  932.            /Z[i,j][E] - default, min chord angle, enhance font - default /Z10,5
  933.  
  934.            This option is not useful with any  HP-GL that  draws circles, arcs,
  935.            and  text  as line segments rather than using HP-GL circle, arc, and
  936.            label commands.
  937.  
  938.            The Z option specifies  the default  and  minimum chord  angles  for
  939.            circles and arcs. The HP 7475 defaults to a chord angle of 5 with no
  940.            minimum.  Using chord  angles  of less than  10 returns little print
  941.            quality improvement  and  adds to  processing time.  The  default is
  942.            /Z10,5. For better emulation use /Z5,2.
  943.  
  944.            The E suboption says to  use  the enhanced  font, which doubles  the
  945.            number of chords on curves in text,  improving the curve smoothness.
  946.            This is only effective on character heights above .5 cm.
  947.  
  948.            /Z5,2  sets the default chord angle to 5 degrees, the minimum to 2
  949.                                                                               
  950.  
  951.                                                                            p-18
  952.          PrintGL Menu Interface (PMI) -----------------------------------------
  953.  
  954.            PrintGL Menu Interface  (PMI) is a menu driven program that lets you
  955.            select PrintGL options, choose a list of plotfiles, and run PrintGL.
  956.  
  957.            To run  PrintGL Menu  Interface, enter  PMI at the  DOS prompt,  and
  958.            press Enter. There are no command line options. The PMI main menu is
  959.            displayed at the top of the screen, and the bottom  of the screen is
  960.            used  differently for each main menu  option.  The  PMI main menu is
  961.            divided by column into six groups. Each group is described below.
  962.  
  963.            When the cursor is on a  main menu  item, the current  value  of the
  964.            option is displayed below the main menu.  To change the value, press
  965.            Enter (or left mouse  button).  The options are modified with cursor
  966.            movement and typing numbers/names.  The Enter key returns you to the
  967.            main menu with the new  option values.  Esc (or  right mouse button)
  968.            returns you to the main menu with the option values unchanged.
  969.  
  970.            If  one of the first two letters of a main menu item is capitalized,
  971.            that item may be accessed immediately by pressing the letter.
  972.  
  973.            When a cursor bar has a notch, the value in the notch may be edited.
  974.  
  975.          PMI Specific Functions -----------------------------------------------
  976.  
  977.            The first column of main menu options is dedicated to PMI functions.
  978.            These   include  running   PrintGL,  switching   to   an   alternate
  979.            configuration, exiting PMI,  saving  the current PMI configurations,
  980.            setting  PMI options, and creating a  BAT file corresponding to  the
  981.            current PMI configuration.
  982.  
  983.            The  "Alt config" item rotates between five PMI configurations.  The
  984.            current configuration name is on line 2.
  985.  
  986.            The "save configs" item saves all of the current PMI configurations.
  987.            The plotfile  list  is not saved.  PMI  saves its  configuration  by
  988.            writing  to  PMI.EXE.  To  find  PMI.EXE it  looks  in  the  current
  989.            directory  and  then  searches the  DOS  PATH,  saving to  the first
  990.            PMI.EXE that it finds.
  991.  
  992.            The  "menu options" item lets you  set the configuration name, mouse
  993.            sensitivity,  screen colors, up  to five initial plotfile masks, and
  994.            the name of the BAT file created by the "create BAT" option.  Screen
  995.            colors are specified with the standard IBM BIOS attributes.
  996.  
  997.            For color displays, the left hex  digit is the  background color and
  998.            the  right hex digit is the foreground color.  Bright colors are not
  999.            available in the background.
  1000.  
  1001.              0 black       4 red           8 gray (bright)     C bright red
  1002.              1 blue        5 magenta       9 bright blue       D bright magenta
  1003.              2 green       6 brown         A bright green      E bright yellow
  1004.              3 cyan        7 white         B bright cyan       F bright white
  1005.  
  1006.            "create BAT" creates a  BAT  file  that  can  be  run  with "batfile
  1007.            hpglfile /opt1 /opt2 ..".  The BAT file contains the options defined
  1008.            by the current PMI configuraton and accepts additional options.
  1009.                                                                               
  1010.  
  1011.                                                                            p-19
  1012.          PMI Input and Output Choices -----------------------------------------
  1013.  
  1014.            Column  two of the main menu  lets  you choose the plotfiles to plot
  1015.            (the /P option  in  PrintGL),  the plot page number (/N), the output
  1016.            destination (/D),  the output format  (/F), and modifications to the
  1017.            output - compression mode, device resolution override and prefix and
  1018.            suffix printer codes (/J,/K).
  1019.  
  1020.            You may enter up to 99 plotfiles in the "plotfile" main menu option.
  1021.            To  choose from a  list of files, enter a  mask name and press Enter
  1022.            (the cursor must  be on the  mask).  PMI will then display a list of
  1023.            corresponding  files.  Select  any number of the files by moving the
  1024.            cursor  to the desired file and pressing Space  (or the middle mouse
  1025.            button). If no files have been selected, then pressing Enter selects
  1026.            the file under the cursor.  The selected files are added to the file
  1027.            list at  or below  the  cursor.  Files that would overflow the  99th
  1028.            position on the plotfile list are dropped.
  1029.  
  1030.            When you run PrintGL, PMI runs PrintGL for each file on the plotfile
  1031.            list.  Masks are ignored.  For any  plotfiles that PrintGL does  not
  1032.            successfully process, PMI inserts an arrow in front of the  plotfile
  1033.            name.  You  can view the results from the "plotfile" main menu item.
  1034.            The arrow is not considered  part of the file name by PMI, so you do
  1035.            not need to remove it to retry PrintGL.
  1036.  
  1037.            Printers that  support  color  have  a  color  option ("clr:" on the
  1038.            menu).  This lets you specify a  black/white printer even though you
  1039.            may have set  up colors with the  "pen color"  menu.  Output formats
  1040.            that do not support color do not have this option and always convert
  1041.            the selected colors to black and white.
  1042.  
  1043.            Bit map formats let you select the resolution in the "output format"
  1044.            list, but it  will be overridden with  the "modify output" "override
  1045.            h,v dpi" option.
  1046.  
  1047.          PMI Plot Options -----------------------------------------------------
  1048.  
  1049.            The third  column of  main  menu options  define  how the  plot will
  1050.            appear on the  page.  The options include magnification (/M), origin
  1051.            (/O), position (/A), and initial scaling points (/I).
  1052.  
  1053.            Left handed (mirrored) orientations are not available from PMI.
  1054.  
  1055.          PMI Pen Options ------------------------------------------------------
  1056.  
  1057.            The  fourth   column   of   main   menu  options   covers   the  pen
  1058.            characteristics: color (/C),  shade (/S),  and width  (/W).  Each of
  1059.            these menus use the up and down cursor keys to select a pen, and the
  1060.            left and right cursor keys to choose an attribute. Only fifteen pens
  1061.            are supported in PMI.
  1062.  
  1063.            For  color  selection,  the  one character  colors (b,c,g,k,m,r,w,y)
  1064.            represent  pure  colors,  and  the  two character  colors are  shade
  1065.            pattern mixes.  The  shade pattern  mixed  colors  use  the  current
  1066.            shading  option  for  that  pen,  unless the  shade  pattern is 100%
  1067.            (solid), in which case a one dot checkerboard is used.
  1068.                                                                               
  1069.  
  1070.                                                                            p-20
  1071.          PMI Page Layout Options ----------------------------------------------
  1072.  
  1073.            The fifth column of main  menu options covers the  page layout.  The
  1074.            first three items are suboptions of the /L option - print window and
  1075.            margins, form feed, and box. Tiling options (/B) and multiple copies
  1076.            (/Q) are also here.
  1077.  
  1078.            Reverse image is not available from PMI.
  1079.  
  1080.          PMI Other Options ----------------------------------------------------
  1081.  
  1082.            Options that  are generally set  once and then never  touched are in
  1083.            column six.  These include the temporary file  name (/T), and  under
  1084.            "other",  the  default  and  minimum chord  angle  (/Z), plotter D/Y
  1085.            switch setting (/Y), internal resolution  (/R), pen  overwrite  mode
  1086.            (opaque lines - /LO), and the pause to load paper option (/X).
  1087.  
  1088.          Large Paper ----------------------------------------------------------
  1089.  
  1090.            PrintGL can handle  printing on paper  larger than the usual 8.5x11,
  1091.            but this takes some extra work. First you need to increase PrintGL's
  1092.            print window to  cover the  large paper.  This  is  done with the /L
  1093.            option  or "print window" in PMI.  The print window plus the margins
  1094.            (/L  or "print margins")  must fit within  the  printer's  printable
  1095.            area.
  1096.  
  1097.            And then you must make  sure that your printer recognizes the larger
  1098.            paper height.  For  continuous  forms paper  this  is  best  done by
  1099.            setting skip perforation to off,  either by  printer switch or  with
  1100.            PrintGL prefix codes.  For Canon, Epson, Fujitsu, IBM, and NEC  line
  1101.            printers (dot  matrix,  ink jet, thermal) use  /J27  79,  or "modify
  1102.            output" "prefix codes" 27 79.
  1103.  
  1104.            For cut sheet paper, on Canon,  Epson, Fujitsu,  IBM,  and  NEC line
  1105.            printers use /J27 67 0 n, where n is the page length in inches.
  1106.  
  1107.            And for  some  printers you need to increase the right margin past 8
  1108.            inches. For the Canon BJC this is done with /J27 81 114.
  1109.  
  1110.            For  page printers,  legal  size paper  may be specified with  these
  1111.            printer  code  prefixes: HP-PCL printers /J27 38 108 51  65 (/K27 38
  1112.            108 50 65 to reset  to 11 inch paper), Canon LBP printers /J27 91 51
  1113.            50 59 59 112 (/K27  91 51 48 59 59 112  to  reset), IBM LaserPrinter
  1114.            /J27 91 70 5 0 3 1 2 1 (/J27 91 70 5 0 3 1 1 1 to reset).
  1115.  
  1116.            To get  a 10x16  print  window  on  11x17  paper in a  Canon, Epson,
  1117.            Fujitsu, IBM, or NEC line  printer, use  these options:  /LF10 16 .4
  1118.            .25 /J27  67 0 17.  You will probably need to adjust the margins (.4
  1119.            .25) for best centering.
  1120.  
  1121.            The  maximum  width of the  print  window  on  most narrow  carriage
  1122.            printers is 8  - 8/(horizontal dpi).  For  300 dpi printers, this is
  1123.            7.97. At 120 dpi printers it is 7.93. The maximum width of the print
  1124.            window on most wide carriage printers is 13.6 - 8/(horizontal  dpi).
  1125.            At 180 dpi this  is 13.55.  At 360 dpi  it is 13.57.  The horizontal
  1126.            print margin should be set to 0 to get this width.
  1127.                                                                               
  1128.  
  1129.                                                                            p-21
  1130.          Tips On AutoCAD ------------------------------------------------------
  1131.  
  1132.            There are many ways to use PrintGL with AutoCAD.  Here is a good way
  1133.            to start.
  1134.  
  1135.            Configure  AutoCAD for an HP 7550 plotter.  Select output to a file.
  1136.            Do not do any plotter calibration. Set a specific scale, do not fit.
  1137.            Do not rotate.  Set  a plotter  window that is larger than  you will
  1138.            ever  need,  30x30  for  example  (this  will  prevent  AutoCAD from
  1139.            clipping the  plot).  Set  up your plotter  pen table so  that  each
  1140.            screen color is assigned a different pen.
  1141.  
  1142.            With  PrintGL  you can  rotate  (/O  or  "origin"),  magnify  (/M or
  1143.            "magnification"), assign pens (/C,/S,/W or "pen color", "pen shade",
  1144.            "pen  width"), and calibrate (/F  or  "modify output" "override  h,v
  1145.            dpi").  Use /A or "position" "plot center at print window center" to
  1146.            automatically center your plot in the print window.
  1147.  
  1148.          Answers --------------------------------------------------------------
  1149.  
  1150.            If your plot is messed up, with  wraparound lines covering the page,
  1151.            you have probably exceeded PrintGL's internal coordinate limit. This
  1152.            happens when the HP-GL  coordinates  exceed 32  inches.  Reduce  the
  1153.            internal resolution  with "other" "internal  dpi: 762" or /R762  for
  1154.            coordinates up to 42  inches  or /R508  for  coordinates  up  to  64
  1155.            inches.
  1156.  
  1157.            If  you  are having trouble getting  the print  size  or location as
  1158.            desired, check your /L option or "print window" and "print margins".
  1159.            The  print  window plus  the print margins must define  an area that
  1160.            fits in the printable area of the paper.  Printers cannot print over
  1161.            the entire area of the paper.  They usually require .25 to  .5  inch
  1162.            margins.
  1163.  
  1164.            If your prints are coming out not quite to scale:
  1165.  
  1166.              Check that no calibration is being done by the graphics package.
  1167.  
  1168.              Use the  "modify  output"  "override  h,v dpi:"  option  or the /F
  1169.              option  to  override  the printer's  nominal  resolution  with the
  1170.              printer's  actual  resolution.  See  /F Output  Format Option  for
  1171.              information on print size correction.
  1172.  
  1173.            For the Canon  BJC-800, the right margin  defaults to 8 inches.  Use
  1174.            "modify output" "prefix codes: 27 81 114" or  /J27 81 114 to set  it
  1175.            to  11.4 inches.  Because the margin can only be  set  once  between
  1176.            printer  resets, you may need to use  /J27 64 27 81 114 (27 64  is a
  1177.            printer reset).
  1178.  
  1179.            For the Canon BJ-330 and most  other wide  carriage PC printers, the
  1180.            maximum  print  window width  is 13.57  inches.  This is  a  printer
  1181.            limitation that you cannot get around.
  1182.  
  1183.            If your  printer ejects the paper  before the plot is  finished, you
  1184.            probably needed to specify a paper length prefix code. For most line
  1185.            printers use /J27 67 0 n where n is the page length in inches.
  1186.                                                                               
  1187.  
  1188.                                                                            p-22
  1189.          Useful Prefix and Suffix Codes ---------------------------------------
  1190.  
  1191.            Below,  n  represents any number 0..255, nA represents any number in
  1192.            ASCII format (1 becomes 49, 2 becomes 50, 43 becomes 52 51, etc.).
  1193.  
  1194.            Canon, Epson, Fujitsu, IBM, NEC dot matrix and inkjet printers
  1195.              Reset                    27 64
  1196.              N line paper             27 67 n
  1197.              N inch paper             27 67 0 n
  1198.              17 inch paper            27 67 0 17
  1199.              Skip perforation off     27 79
  1200.              Right margin n columns   27 81 n         (not compatible with IBM)
  1201.              Unidirectional printing  27 85 1
  1202.  
  1203.            HP-PCL printers
  1204.              Reset                 27 69
  1205.              Portrait mode         27 38 108 48 79
  1206.              Top margin 0          27 38 108 48 69
  1207.              Skip perforation off  27 38 108 48 76
  1208.              11 inch paper         27 38 108 50 65
  1209.              14 inch paper         27 38 108 51 65
  1210.              11x17 inch paper      27 38 108 54 65
  1211.              manual feed           27 38 108 50 72
  1212.              N copies              27 38 108 nA 88         (page printers only)
  1213.  
  1214.            HP DeskJet 500C
  1215.              High quality, slow  27 42 111 49 81
  1216.              No ink depletion    27 42 111 49 68
  1217.  
  1218.            HP PaintJet XL300
  1219.              Low quality, fast  27 42 111 45 49 81
  1220.  
  1221.            PostScript
  1222.              N copies      nA 32 88 67
  1223.              Paper tray n  nA 32 88 80
  1224.  
  1225.            IBM LaserPrinter
  1226.              11 inch paper, tray 1, n copies  27 91 70 5 0 3 1 1 n
  1227.              14 inch paper, tray 1, n copies  27 91 70 5 0 3 1 2 n
  1228.              14 inch paper, manual, n copies  27 91 70 5 0 1 1 2 n
  1229.              N copies                         27 91 70 5 0 0 0 0 0 n
  1230.  
  1231.            Canon LBP
  1232.              Reset                  27 99
  1233.              11 inch paper          27 91 51 48 59 59 112
  1234.              14 inch paper          27 91 51 50 59 59 112
  1235.              Manual feed            27 91 49 113
  1236.              Automatic feed         27 91 48 113
  1237.              Full page memory mode  27 59 27 91 50 38 122
  1238.              N copies               27 91 nA 118
  1239.              Cursor to top of page  27 91 48 100
  1240.              Diablo mode            27 58
  1241.              ISO mode               27 59
  1242.  
  1243.            HP QuietJet
  1244.              HP-PCL mode      27 37 65
  1245.              DIP switch mode  27 37 64
  1246.                                                                               
  1247.  
  1248.                                                                            p-23
  1249.          Display Output -------------------------------------------------------
  1250.  
  1251.            When  you display a plot, the cursor keys scroll the plot, S  cycles
  1252.            between  full,  half   (the  default),  quarter,   and  eighth  page
  1253.            scrolling, and Esc returns to DOS.
  1254.  
  1255.            /FC drives a CGA, but does not give color.
  1256.  
  1257.            The EGA drivers, /FE and /FM, require a 128K or 256K EGA.  /FC  will
  1258.            work with  a 64K EGA.  /FM  is for an EGA card  with a digital (TTL)
  1259.            monochrome monitor.
  1260.  
  1261.            /FH supports the Hercules monochrome graphics card.
  1262.  
  1263.            /FV works with any VGA card.
  1264.  
  1265.            /FV+  requires a  system with 800x600  16 color support.  By default
  1266.            /FV+ assumes  VESA  support.  If your VGA card does not support VESA
  1267.            functions then specify the mode number that selects 800x600 16 color
  1268.            mode. Here are /FV+ options for common VGA cards ($ means hex).
  1269.  
  1270.              ATI    /FV+$54      Paradise     /FV+$58      Trident      /FV+$5B
  1271.              Genoa  /FV+$29      Renaissance  /FV+$64      Video Seven  /FV+$16
  1272.  
  1273.            /FV* works with VESA systems that support 1024x768 16 color mode.
  1274.  
  1275.            For MCGAs, use the VGA driver without color - /FV~.
  1276.  
  1277.            Display  output cannot be  redirected  to  a  file (the /D option is
  1278.            ignored).
  1279.  
  1280.          PostScript Output ----------------------------------------------------
  1281.  
  1282.            /FS outputs printable Encapsulated  PostScript  with no preview  bit
  1283.            map.  Text,  arcs,  fill, and clips  are  converted  to  vectors, so
  1284.            PrintGL is not a general purpose  HP-GL to PostScript converter.  If
  1285.            no form feed is  specified then  "showpage" is not  output, and more
  1286.            PostScript may be appended to the page.  PostScript overwrites as it
  1287.            draws, so overlapping lines appear opaque.
  1288.  
  1289.            You  can  specify  the  nominal  resolution  of  the  PostScript  by
  1290.            appending it to the /F option (for example /FS 300).
  1291.  
  1292.            You  can specify the  number  of  copies  with  a  prefix code  that
  1293.            includes the number of copies followed by  ' XC'.  For example /J 50
  1294.            32 88 67 makes 2 (ASCII 050) copies.  You can specify the paper tray
  1295.            with the XP macro.
  1296.  
  1297.            /FY appends a black/white TIFF preview bit map to a PostScript file.
  1298.            To  use  it,  create  a  PostScript  file with PrintGL  and then run
  1299.            PrintGL again, specifying the  same  options except /FY  instead  of
  1300.            /FS.  The  destination  file is appended  by default.  /FY assumes a
  1301.            PostScript file,  generated by  PrintGL, is being appended.  You may
  1302.            set the resolution - the default is 72x72 dpi. Here is an example:
  1303.  
  1304.              PRINTGL sample.plt /Dsample.eps/LB6,6/O2/FS
  1305.              PRINTGL sample.plt /Dsample.eps/LB6,6/O2/FY
  1306.                                                                               
  1307.  
  1308.                                                                            p-24
  1309.          HP-GL and HP-GL/2 Output ---------------------------------------------
  1310.  
  1311.            /F8  outputs low level HP-GL, converting all  text,  arcs, fill, and
  1312.            clips to vectors.  The output is HP 7220 compatible, containing only
  1313.            IN, IP, SC, SP, IW, LT, PA, PU, and PD commands. PG is added if form
  1314.            feed is specified (the  default).  If you decline the form feed then
  1315.            multiple plots may be appended to the same page.
  1316.  
  1317.            /F0  drives  HP-GL/2 raster  devices.  /F8  produces  HP-GL  that is
  1318.            compatible with HP-GL/2 pen plotters.
  1319.  
  1320.            You can specify the  nominal  resolution  of  HP-GL  or  HP-GL/2  by
  1321.            appending it to the  /F option (for example /F8  300).  When you set
  1322.            the nominal resolution  of  HP-GL  to other than  1016, enhanced  IW
  1323.            command  interpretation  (HP 7550 enhanced mode) is needed to handle
  1324.            dashed lines correctly.
  1325.  
  1326.            For HP-GL  output,  PrintGL uses its width parameter (/W)  as a  pen
  1327.            selector, so for each pen in the  original HP-GL, you may  specify a
  1328.            new  pen in the output HP-GL.  The  default  /W option is /W12345678
  1329.            (for /F8). Shading and color are ignored.
  1330.  
  1331.          ZSoft PCX Bit Map Output ---------------------------------------------
  1332.  
  1333.            /FZ gives ZSoft PCX bit map  output.  Multiple  page plots and tiled
  1334.            plots do not work well with PCX output because PCX has no facilities
  1335.            for multiple pages in one file. Here is the format used by PrintGL.
  1336.  
  1337.            The file starts with a header composed of 128 byte values:
  1338.  
  1339.              10,2,1,1,0,0,0,0,
  1340.              max_x,max_y,                              2 bytes each, in dots
  1341.              dpi_x,dpi_y,                              2 bytes each
  1342.              0,0,0,    0,0,192,  0,192,0,  0,192,192,  color palette
  1343.              192,0,0,192,0,192,192,192,0,192,192,192,
  1344.              0,0,0,    0,0,254,  0,254,0,  0,254,254,
  1345.              254,0,0,254,0,254,254,254,0,254,254,254,
  1346.              0,
  1347.              color_planes,                             1, 3, or 4
  1348.              width                                     2 bytes, in bytes
  1349.              1,0,..,0
  1350.  
  1351.            The scan lines follow, in top to bottom order. For color plots, each
  1352.            complete  scan  line consists  of a  blue, green, red, and intensity
  1353.            scan line.  The intensity line  is not included for /FZ`.  1 is  the
  1354.            background  and  0 the  foreground  for  b/w  files.  1,1,1,1 is the
  1355.            background for color files, with 0 representing the absence of blue,
  1356.            green, red, or intensity.  The bit usage is reversed with /LR.  Each
  1357.            scan line is composed of these data commands ($ means hex):
  1358.  
  1359.              $00..$BF           - 1 byte of bit mapped data ($00..$BF)
  1360.              $C1 $C0..$FF       - 1 byte of bit mapped data ($C0..$FF)
  1361.              $C2..$FF $00..$FF  - 2..63 bytes of repeated bit mapped data
  1362.  
  1363.            The width and height of the  bit map are  specified by the /L option
  1364.            plus eight dots. The width is extended to a multiple of sixteen.
  1365.                                                                               
  1366.  
  1367.                                                                            p-25
  1368.          Printer Output -------------------------------------------------------
  1369.  
  1370.            Canon BJ and BJC Printers, IBM ExecJet
  1371.  
  1372.              For the BJ130e,  BJ5, BJ10,  BJ20,  BJ300,  BJ330,  and ExecJet in
  1373.              Proprinter  mode, use /F7.  This is the fastest  driver for  these
  1374.              printers. /F7+ gives dark print with line to line overlap.
  1375.  
  1376.              /FJ works with any Canon BJ printer in BJ130 mode.  The printer is
  1377.              set to 10 pitch text when finished.
  1378.  
  1379.              You can use  /FT or  /FT* (the Epson  LQ drivers) with  the BJ  or
  1380.              ExecJet printers in Epson LQ mode, but /FT* is very slow.
  1381.  
  1382.              These printers  have an image  density option (switch  1-9 on  the
  1383.              BJ130,  1-4  on  the  BJ300,  BJ330,  and  ExecJet).  Low  density
  1384.              eliminates  every second dot.  To get the full 360 dpi resolution,
  1385.              use high density.  For the BJ300, BJ330, and ExecJet, also be sure
  1386.              that the front panel FONT HQ (high quality) light is on.
  1387.  
  1388.              Use /FB for Canon BJC printers. The prefix code 27 81 114 sets the
  1389.              right margin to 11.4 inches. /FB+ gives a sparse line overlap.
  1390.  
  1391.            Canon LBP Printers
  1392.  
  1393.              /FD  works  with any Canon LBP printer in ISO mode.  At 300 dpi it
  1394.              takes up to one  meg  of  printer memory to print a full  page  of
  1395.              graphics. At 150 dpi (/FD-) 512K handles a full page.
  1396.  
  1397.              It  may help to set the printer memory mode with /J27 59 27 91  50
  1398.              38 122.
  1399.  
  1400.              If the printer is in Diablo mode, PrintGL switches to ISO mode. To
  1401.              switch back to Diablo mode on completion, use /K27 58.
  1402.  
  1403.            Epson, IBM 9 Pin Printers
  1404.  
  1405.              /FN, /FW, and /F1 cover a wide range of Epson/IBM compatible 9 pin
  1406.              dot matrix printers.  You need a  cyan/magenta/yellow/black ribbon
  1407.              to get color prints. The * drivers use 1/240 graphics. /FN+, /FN*,
  1408.              /FW+,  and  /FW*  use  1/216  indexing  and  do  three  vertically
  1409.              interleaved passes.  /F1+  and /F1* use  1/144 indexing and do two
  1410.              vertically interleaved passes. /FW sets line feeds to 1/6 inch.
  1411.  
  1412.              For  Epson printers, the IBM  Graphics Printer, and other printers
  1413.              with 1/216 indexing hardware, /FN is preferred. For some not quite
  1414.              compatible  printers,  /FW works.  For IBM  Proprinters and  other
  1415.              printers  with 1/144 indexing hardware, /F1 gives better  results.
  1416.              Some Proprinters do not handle 1/240 graphics correctly.
  1417.  
  1418.              These drivers use the following escape codes:
  1419.  
  1420.                esc 3  set n/216 line feeds for all /FW
  1421.                esc J  index n/216 (n=2 for 1/144 index) for all /FN and /F1
  1422.                esc L  graphics command for /FN, /FN+, /FW, /FW+, /F1, and /F1+
  1423.                esc Z  graphics command for /FN*, /FW*, and /F1*
  1424.                esc r  set ribbon color (only if color is specified)
  1425.                                                                               
  1426.  
  1427.                                                                            p-26
  1428.            Epson, Fujitsu, NEC, Toshiba 24 Pin Printers
  1429.  
  1430.              /FT  covers  all  Epson LQ printers and  many  compatible printers
  1431.              (Panasonic in LQ mode and others).  /FF works with  Fujitsu 24 pin
  1432.              printers in Fujitsu mode.  /F9 works with NEC 24 pin printers. /FO
  1433.              works  with Toshiba 24  pin printers.  /FO  resets the  line  feed
  1434.              distance to 1/6 inch on completion.
  1435.  
  1436.              For all of these  drivers,  you need  a  cyan/magenta/yellow/black
  1437.              ribbon to get color prints. The + and * drivers use 1/360 graphics
  1438.              mode, and the *  drivers use 1/360 (1/120  for /FO*)  indexing and
  1439.              reset the line feed distance  to  1/6 inch on completion.  A clean
  1440.              paper  path  with equal tension on  each side  is  needed for good
  1441.              360x360 graphics.
  1442.  
  1443.              Many 24 pin printers are not capable of 360x360 graphics and a few
  1444.              cannot handle 360x180 graphics.
  1445.  
  1446.              The compression mode drivers (!  suboption)  may or  may not be an
  1447.              improvement with these printers.
  1448.  
  1449.              The /FT drivers use the following printer escape codes:
  1450.  
  1451.                esc $    absolute tab
  1452.                esc * '  graphics command for /FT
  1453.                esc * (  graphics command for /FT+, /FT*
  1454.                esc +    set n/360 indexing for /FT*
  1455.                esc 2    set 1/6 indexing for /FT*
  1456.                esc J    index n/180 for /FT, /FT+
  1457.                esc r    set ribbon color (only if color is specified)
  1458.  
  1459.            HP DeskJet, HP PaintJet XL300, Mannesmann Tally MT92C
  1460.  
  1461.              /FI works with any black/white DeskJet in portrait mode.
  1462.  
  1463.              /FA drives the  DeskJet 500C, PaintJet XL300, MT92C, and any color
  1464.              300 dpi HP-PCL printer that supports data transfer mode 2.
  1465.  
  1466.            HP LaserJet
  1467.  
  1468.              /FL works with any LaserJet compatible printer. /FU works with the
  1469.              LaserJet 2 and any HP-PCL 4 compatible printer. /FI works with the
  1470.              LaserJet 3 and any HP-PCL 5 compatible printer.
  1471.  
  1472.              The LaserJet 2P will not index correctly with /FI - use /FU.
  1473.  
  1474.              All  of these drivers work in portrait mode, which may be set with
  1475.              /J 27 38 108 48 79 or you can reset the printer with /J 27 69.
  1476.  
  1477.              LaserJets with under one meg of memory may not be able to handle a
  1478.              full page of graphics.  /FU uses less printer  memory than /FI, so
  1479.              it may be preferred on LaserJet 3s with limited memory.
  1480.                                                                               
  1481.  
  1482.                                                                            p-27
  1483.            HP PaintJet
  1484.  
  1485.              /FP drives 180 dpi PaintJet printers.  The compression mode driver
  1486.              (/FP!)  uses  data  transfer  mode 2 (instead of 1) and works only
  1487.              with a PaintJet XL.
  1488.  
  1489.              /FA (the DeskJet 500C driver) works with the PaintJet XL300.
  1490.  
  1491.            HP QuietJet
  1492.  
  1493.              /FQ works with QuietJets  in HP-PCL mode.  /J27  37 65  /K27 37 64
  1494.              sets HP-PCL  mode and  resets  to  the DIP switch selected mode on
  1495.              completion.
  1496.  
  1497.            IBM LaserPrinter
  1498.  
  1499.              /F4 drives any LaserPrinter in PPDS (native)  mode.  /FL will work
  1500.              if the LaserPrinter is in HP LaserJet mode, but this may be slower
  1501.              than  PPDS mode.  At  300 dpi it takes up to  one meg  of  printer
  1502.              memory  to print a full page of graphics.  At  150 dpi (/F4-) 512K
  1503.              handles a full page.
  1504.  
  1505.            IBM 24 Pin Printers
  1506.  
  1507.              PrintGL has three drivers that  cover  Proprinter  X24  compatible
  1508.              printers. The printers should be in native mode (not AGM).
  1509.  
  1510.              The first driver, /F6, is for all IBM Proprinter X24s and the 24P.
  1511.              These printers do  1/144 inch indexing, and using them at 180  dpi
  1512.              results  in horizontal  white streaks  every  2/3  inch.  The  /F6
  1513.              drivers  compensate  for  this by indexing  19/144 inch  per line,
  1514.              giving  182 dpi.  To work properly, the printer must be on a  1/72
  1515.              boundary when the graphics are printed.  If you keep the line feed
  1516.              distance  a multiple of 1/72 (1/6, 1/8, 1/9) then this will always
  1517.              be the case.
  1518.  
  1519.              The second X24 compatible driver is /F5 and  is referred to as X24
  1520.              alternate 1.  This is for printers that are  X24 compatible except
  1521.              that they  do 1/180 inch indexing.  This is probably the case with
  1522.              most  X24 compatible printers, including the  IBM  Quickwriter and
  1523.              IBM 2390  and 2391.  /F5* works only with printers that can handle
  1524.              1/360  indexing,   including  the  2390  and  2391   but  not  the
  1525.              Quickwriter.
  1526.  
  1527.              The third  X24 compatible  driver is /FX and is referred to as X24
  1528.              alternate  2.  This is  the same  as  /F5 except that the vertical
  1529.              units command uses  a  different  format  that is not strictly IBM
  1530.              compatible.  This driver works  with Panasonic 24 pin  printers in
  1531.              X24 mode.
  1532.  
  1533.              The compression mode drivers (!  suboption)  may or  may not be an
  1534.              improvement with these printers.
  1535.  
  1536.              Proprinter X24 and XL24 printers are very slow with graphics.  The
  1537.              X24E and XL24E are significantly faster.
  1538.                                                                               
  1539.  
  1540.                                                                            p-28
  1541.            IBM Quietwriter 2 and 3
  1542.  
  1543.              /F2 and /F3 drive  the Quietwriter 2 and 3.  Do not use  1 for pen
  1544.              widths because  Quietwriters do not  print consistent 1 dot lines.
  1545.              These  drivers  reset  the  line  feed distance to  1/6  inch upon
  1546.              completion.
  1547.  
  1548.            Kodak Diconix Color 4
  1549.  
  1550.              /FK drives the Color 4.
  1551.  
  1552.            Pacific Data Products ProTracer
  1553.  
  1554.              /FG drives the ProTracer in IBM Proprinter mode. The maximum print
  1555.              window width is 14.97.
  1556.  
  1557.            Tektronix ColorQuick
  1558.  
  1559.              /FR drives the ColorQuick.
  1560.                                                                               
  1561.  
  1562.                                                                            p-29
  1563.          Color Processing -----------------------------------------------------
  1564.  
  1565.            Color graphics devices use a variety of color technologies.  PrintGL
  1566.            supports these basic types.
  1567.  
  1568.            CMY or cyan/magenta/yellow is used by inkjet printers  with no black
  1569.            ink. This uses three color planes and give eight pure colors.
  1570.  
  1571.            CMYK  or cyan/magenta/yellow/black is  used by inkjet and dot matrix
  1572.            printers.  This  uses four color planes  and give eight pure colors.
  1573.            Using  black ink instead of a  cyan/magenta/yellow mix gives a  more
  1574.            neutral black color.
  1575.  
  1576.            RGB or red/green/blue is used by displays  and  bit maps.  This uses
  1577.            three color planes and give eight pure colors.
  1578.  
  1579.            RGBI  or red/green/blue/intensity is used  by displays and bit maps.
  1580.            This uses four  color  planes.  All  simple colors except black  are
  1581.            intense.  When  you specify any color mixed  with black at  shade 0,
  1582.            then instead  of  mixing the colors at 50%, the intensity  is turned
  1583.            off. This gives fifteen pure colors.
  1584.  
  1585.            CMYK and RGBI are used by default when they are appropriate. You can
  1586.            switch to CMY or RGB with the ` suboption of /F.  For displays  this
  1587.            gives a better picture of how a printer will handle the colors.  For
  1588.            dot matrix printers it may speed printing by  eliminating the use of
  1589.            the black ribbon.
  1590.  
  1591.          HP-GL Commands -------------------------------------------------------
  1592.  
  1593.            PrintGL  supports the 7475 and  7440/17440 command sets  except  for
  1594.            character set  8 (Katakana), digitize commands, output commands, the
  1595.            error mask command,  and some device control commands.  In addition,
  1596.            PG, AF, ES, LO, character set 5, and proportional spaced fonts, from
  1597.            the 7550,  are supported.  And  forty pens  are  allowed  instead of
  1598.            eight.
  1599.  
  1600.            HPGL.DOC  and  HPGL.CHR include more details of HP-GL  and PrintGL's
  1601.            interpretation. The 7550 manual is the best reference for HP-GL - HP
  1602.            manual 07550-90001.
  1603.                                                                               
  1604.  
  1605.                                                                            p-30
  1606.          Compatibility and Technical Information ------------------------------
  1607.  
  1608.            PrintGL and  PMI will run on any  IBM compatible system with  MS-DOS
  1609.            2.0 or above. It requires up to 256K of free memory. More memory may
  1610.            speed printing.
  1611.  
  1612.            By default, PrintGL uses the BIOS printer interrupt to send  data to
  1613.            the printer. The H1..H4 and X1..X4 drivers send data directly to the
  1614.            serial port, without using or setting the hardware interrupts.  If a
  1615.            file or device is specified for output then DOS 2.0 file handling is
  1616.            used.  Messages are written to  the  screen  with  standard  DOS CON
  1617.            output.
  1618.  
  1619.            PMI runs PrintGL via a DOS shell.  It searches the current directory
  1620.            and then the DOS PATH, calling the first copy of PRINTGL.EXE that it
  1621.            finds. To save the settings, it makes the same search for PMI.EXE.
  1622.  
  1623.            PMI can use any text or graphics display  mode that  allows at least
  1624.            80 columns and 25 lines of text.  In text modes, PMI writes directly
  1625.            to the display buffer,  and  in  graphics  modes,  BIOS  is  used to
  1626.            display text. Under DESQview, PMI writes to the DV screen buffer.
  1627.  
  1628.            PRINTGL.EXE may be compressed with PKLITE, LZEXE, or other EXE  file
  1629.            compressors.  PMI should  not  be  compressed  because  it  rewrites
  1630.            PMI.EXE when saving the user settings.
  1631.  
  1632.            PrintGL  and  PMI were  written  by  Cary  Ravitz and compiled  with
  1633.            Borland's Turbo Pascal 6.0 and Turbo Assembler 2.0.
  1634.  
  1635.          User Support ---------------------------------------------------------
  1636.  
  1637.            Correspondence  about  PrintGL may be sent via  the support bulletin
  1638.            board, fax, Compuserve, or mail.
  1639.  
  1640.            BBS:        606-268-0577  1200..9600,N,8,1  24 hours/day
  1641.  
  1642.              To ask a question, prepare an ASCII text file with the details  of
  1643.              your question.  Then call the bulletin board and choose the upload
  1644.              question option.  XMODEM  file transfer  protocol  is required for
  1645.              this.  Your question will  be assigned  a number (such as  1015) -
  1646.              remember this  number.  An answer  file (with the assigned number)
  1647.              will  be posted, usually within  24 hours.  To get an answer, call
  1648.              the  bulletin board,  choose the download option,  then the answer
  1649.              option, and then enter the answer number.
  1650.  
  1651.            Compuserve: Cary Ravitz [70431,32]
  1652.  
  1653.            Fax:        606-268-0577
  1654.  
  1655.              If you hand dial,  the  BBS will  answer  and  hang up  (about  20
  1656.              seconds), then the call  is routed to the  fax.  The  fax  may  be
  1657.              unavailable sometimes.
  1658.  
  1659.            Mail:       Ravitz Software Inc.
  1660.                        P.O. Box 25068
  1661.                        Lexington, KY  40524-5068
  1662.                        USA
  1663.